Skip to main content
POST
/
v1
/
kyc
/
customers
/
{subaccountId}
/
submit
Tier Two | Submit Individual Information
curl --request POST \
  --url https://api.bullring.finance/v1/kyc/customers/{subaccountId}/submit \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{}'
{
  "status": "incomplete",
  "rejection_reasons": [],
  "endorsements": [
    {
      "name": "base",
      "status": "incomplete",
      "additional_requirements": [
        "kyc_approval"
      ]
    },
    {
      "name": "sepa",
      "status": "incomplete",
      "additional_requirements": [
        "kyc_approval",
        "kyc_with_proof_of_address"
      ]
    }
  ],
  "created_at": "2025-12-31T10:37:53.156Z",
  "updated_at": "2025-12-31T10:38:25.087Z",
  "lastSubmissionAt": "2025-12-31T10:38:25.084Z",
  "submissionCount": 1,
  "type": "individual",
  "first_name": "Mike",
  "middle_name": null,
  "last_name": "Bull",
  "phone": "+2348012345678",
  "address": {
    "street_line_1": "9 Karimu Street",
    "street_line_2": "",
    "city": "Lagos",
    "state": "LA",
    "postal_code": "105102",
    "country": "NGA"
  },
  "birth_date": "1993-01-24",
  "documents": [
    {
      "purpose": "PROOF_OF_ADDRESS",
      "file": "https://res.cloudinary.com/bullring-finance/image/upload/v1763738205/verification/2025-11-21/n0slzbkhxreppmqew4yd.png"
    }
  ],
  "account_purpose": "payments_to_friends_or_family_abroad",
  "account_purpose_other": null,
  "employment_status": "employed",
  "expected_monthly_payments_usd": "FROM_5000_TO_9999",
  "acting_as_intermediary": false,
  "most_recent_occupation": "ACCOUNTANT_AND_AUDITOR",
  "source_of_funds": "inheritance",
  "identifying_information": [
    {
      "type": "passport",
      "issuing_country": "NGA",
      "number": "12345678909",
      "image_front": "https://res.cloudinary.com/bullring-finance/image/upload/v1763738198/verification/2025-11-21/t2fgqlxesqigmm0qfvbi.png",
      "image_back": "https://res.cloudinary.com/bullring-finance/image/upload/v1763738205/verification/2025-11-21/n0slzbkhxreppmqew4yd.png"
    }
  ]
}

Authorizations

x-api-key
string
header
required

Path Parameters

subaccountId
string<uuid>
required

The unique identifier of the subaccount

Body

application/json

The body is of type object.

Response

Submission successful

status
string
rejection_reasons
string[]
endorsements
object[]
created_at
string<date-time>
updated_at
string<date-time>
lastSubmissionAt
string<date-time> | null
submissionCount
integer
type
string
first_name
string
middle_name
string | null
last_name
string
phone
string
address
object
birth_date
string<date>
documents
object[]
account_purpose
string
account_purpose_other
string | null
employment_status
string
expected_monthly_payments_usd
string
acting_as_intermediary
boolean
most_recent_occupation
string
source_of_funds
string
identifying_information
object[]